home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 #1 / Ham Radio 2000.iso / ham2000 / logs / sslogger / readme < prev    next >
Encoding:
Text File  |  1995-10-26  |  9.2 KB  |  190 lines
  1. ARRL November Sweepstakes Logger
  2. SSLogger, Version 1.0.1, Oct. 26, 1995
  3.  
  4. SSLogger is a native OS/2 logger designed specifically for the ARRL
  5. November Sweepstakes.  This logger features dupe checking, a section list
  6. window that tracks sections worked, a log list window which can be used to
  7. edit log records previously written, recording breaks taken during the course
  8. of the contest, a status window showing various statistics, a built-in
  9. controller for the Kenwood TS-940S, and a facility to export the log to
  10. ARRL Suggested File Format.
  11.  
  12. Setup
  13. =====
  14. Unzip the file SSLogger.zip.  As usual, put the .dll files in some
  15. subdirectory included in your LIBPATH, and all .exe's in some subdirectory
  16. in your PATH.  The INI file must reside in your current subdirectory when
  17. SSLogger is run.  If you include "." in your LIBPATH, you can leave everything
  18. in the same subdirectory if it is your currentl subdirectory. I find it
  19. convenient to drag a program template to create an icon for SSLogger.  Be sure
  20. to set the current directory correctly so that your INI file is found.
  21. SSLogger.exe is the logger itself, and CrLog.exe, described below, will create
  22. a test log for you.  Please read the notes on CrLog.exe before executing it.
  23.  
  24. Creating a log
  25. ==============
  26. Select "Create" under the Files menu option.  Before the prompt for the file
  27. name, a succession of three windows will appear, from which the logger will
  28. obtain information necessary to create the log.
  29.  
  30. -  Contest Information Window.  The window is used to obtain contest dates
  31.    and times, and the contest mode.  The contest times are for documentation
  32.    only and do not impose any limits which log data times must fall within.
  33.  
  34. -  Station Info.  Via this window, provide station info, e.g., callsign,
  35.    precedence, check, and section.
  36.  
  37. -  Time Setup.  SSLogger does not require you to set your system clock to
  38.    UTC.  Use this window to indicate your system clock's offset from
  39.    from UTC.  For example, EST would be -5.  SSLogger uses this information
  40.    to convert times based on your system clock to UTC.
  41.  
  42. These menus can also be accessed at any time under the Settings menu.
  43. A log can be opened again later with the Files->Open menu option.
  44.  
  45. Logging contacts
  46. ================
  47. Before any contacts can be logged, you must first begin contest operation.
  48. The actual operation begin and end is used for statistics.  To begin
  49. operations, select Operation->Begin under the Actions menu.  Select
  50. Operation->Terminate when you are finished with the contest.  Of course, you
  51. can change your mind and select Operation->Begin to cancel out the previous
  52. Operation->Terminate.
  53.  
  54. The operation period can be edited at any time with the Edit Operation Time
  55. window, under Actions->Operation.  Note that dates and times cannot be
  56. changed so as to conflict with other log data already recorded.
  57.  
  58. Now you can log contacts.  Select the proper band and fill in the log data
  59. into the main window. You can tab and backtab through the fields.  The Enter
  60. key acts as a tab.  The ESC key will clear the current field data.  Pressing
  61. ESC again will clear all of the fields and place the cursor in the Callsign
  62. field.  F12 will clear all of the fields and place the cursor in the Callsign
  63. field.  Press F4 to log the contact. If you change the callsign field, a dupe
  64. will be performed as soon as you tab out of the field or press F4.
  65.  
  66. If a dupe check detects a dupe, a message box will pop up and give you the
  67. option to cancel the entry (the normal case) or to force the log entry.
  68. If you force the log entry, no points will be scored for the previous
  69. log entry for that call.
  70.  
  71. Editing log records
  72. ===================
  73. Use the Log window under the Windows menu option to display a list of log
  74. records.  Log records may be edited from this window.  The Logs window is a
  75. modeless dialog, meaning that you can leave it up all the time.  It is updated
  76. whenever log records are added.
  77.  
  78. The date/time of a log entry cannot be updated so that it falls within the
  79. range of a break already recorded.  Similarly, it must fall within the
  80. Operation Begin and Terminate (if contest operation has been terminated) times.
  81.  
  82. Hint:  Alt+L provides a quick way to access the Logs window.  You can leave it
  83. on your desktop behind the main window, or close it or minimize it.  Alt+M
  84. can be used to quickly return to the main window.
  85.  
  86. Recording breaks
  87. ================
  88. ARRL requires you to indicate all breaks taken during the contest.  To begin
  89. a break, select Break->Begin.  To end a break, select Break->Terminate.
  90. Break->Cancel can be used to cancel a break in progress.  The Break
  91. selections are disabled until Operation->Begin has been selected.  If you
  92. select Operation->Terminate and later decide to continue operation and select
  93. Operation->Begin, a break record will be written for that period of no
  94. operation.  Breaks of any length may be recorded, but ARRL only counts breaks
  95. of 30 minutes or more.  Thus, the status window (described below) only counts
  96. breaks of at least 30 minutes.  Similarly, the log exported to ARRL Suggested
  97. File Format will only show breaks of sufficient duration.
  98.  
  99. Breaks may be listed and edited with the Edit Break Times menu.  You can bring
  100. up this menu by selecting Actions->Breaks->Edit Break Times.  Note that break
  101. times cannot be updated so as to conflict with other log data already recorded.
  102. For example, it would be an error to edit a break period so that a log record
  103. already written falls within that interval.  Similarly, the break must fall
  104. within the time of operation.
  105.  
  106. Section List
  107. ============
  108. The section list can be used to track sections worked and to look up the
  109. correct abbreviation.  This modeless window can be left up while logging and
  110. is always updated to refect any log changes.  To display the window, select
  111. Section List under the Windows menu option.  Hint:  Alt+S provide quick
  112. access to the Section list.  Use Alt+M to quickly return to the main window.
  113.  
  114. Status Window
  115. =============
  116. The Status Window is a modeless window which displays current statistics,
  117. including number of contacts/hr., contacts count, section count, score,
  118. time off, actual time spent operating, and total time.
  119.  
  120. Transceiver Control
  121. ===================
  122. If you have a Kenwood TS-940S with the option for computer control, you can
  123. let the SSLogger provide some basic control and monitoring.  First, you should
  124. select Settings under the Transceiver menu option to indicate which com port
  125. your transceiver is connect to.
  126.  
  127. In the Transceiver Settings window, you will also find a list of frequencies,
  128. one per band per mode.  These frequencies are be used by SSLogger when you
  129. switch bands using the Band control in the main window.  When you have selected
  130. a new band, the transceiver switches to the corresponding frequency in the
  131. Tranceiver Settings menu.  SSLogger is constantly monitoring your current
  132. frequency.  You can opt to switch back to the most recently used frequency for
  133. a band if you check the checkbox with a like heading in the Transceiver
  134. Settings window.
  135.  
  136. If you use the transceiver to change to another band, SSLogger will
  137. automatically update the band control accordingly.
  138.  
  139. Connect to the transceiver by selecting Transceiver->Connect->Kenwood TS940.
  140. You can disconnect from the transceiver by selecting Transceiver->Disconnect.
  141.  
  142. Miscellaneous
  143. =============
  144. SSLogger.INI
  145. ------------
  146. Window coordinates for the SSLogger window, Section List window, Log window,
  147. and Status window are saved in SSLogger.INI and restored when you bring
  148. up SSLogger.  Also, Station Info, Time Setting, and Transceiver Settings data
  149. are saved in SSLogger.INI.
  150.  
  151. CrLog.EXE
  152. ---------
  153. I have included the program CrLog.exe to generate relatively quickly a large
  154. log of 1000 records that you can use to familiarize yourself with the various
  155. SSLogger functions.
  156.  
  157. For maximum data integrity, SSLogger uses synchronous writes so that data is
  158. written immediately and not buffered and written whenever the filesystem driver
  159. decides to write the data.  This means that CrLog will run very slowly.  Of
  160. course, in normal operation, you are not writing such large amounts of data so
  161. quickly and you should not notice a significant performance degradation.
  162.  
  163. Reliability
  164. -----------
  165. I haven't tested this logger in actual operation, but I haven't been able
  166. to corrupt the log, so I believe that it is pretty reliable.  Please take
  167. this into account, though, if you plan a serious contest operation.
  168.  
  169. Known Problems
  170. --------------
  171. I wrote and tested this logger on a monitor with 1024 x 768 resolution.  When
  172. I tested SSLogger on a 1280 x 1024 display, I noticed that some of the fonts
  173. did not scale with the windows, particularly the scrollable lists and the
  174. main window pushbutton text.  Hopefully, this will only be a minor annoyance
  175. to users with displays with resolutions other than 1024 x 768.
  176.  
  177. Please read FIXES.LOG for change history.
  178.  
  179. Author Comments
  180. ---------------
  181. I offer this logger as shareware and am asking for no fees or donations.
  182. I hope you enjoy this logger and find it to be useful and effective in your
  183. November Sweepstakes Contest operation.  I welcome any comments and
  184. suggestions.
  185.  
  186. Will Edwards, WA5WZA
  187. 14803 Chicadee Circle
  188. Pflugerville, TX 78660-8168
  189. 
  190.